Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

GetMoviePreviewTime

The GetMoviePreviewTime function returns the starting time and duration of the movie's preview. These time values are expressed in the movie's time coordinate system.

pascal void GetMoviePreviewTime (Movie theMovie, 
                                 TimeValue *previewTime,
                                 TimeValue *previewDuration);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

previewTime

Contains a pointer to a time value. The Movie Toolbox places the preview's starting time into the field referred to by this parameter. If the movie does not have a preview, the Movie Toolbox sets this returned value to 0.

previewDuration

Contains a pointer to a time value. The Movie Toolbox places the preview's duration into the field referred to by this parameter. If the movie does not have a preview, the Movie Toolbox sets this returned value to 0.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

Your application sets the starting time and duration of the movie preview with the SetMoviePreviewTime function, which is described in the previous section.